home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / System7 tools / S / Shane the Plane ƒ / Shane the Plane - Read Me next >
Encoding:
Text File  |  1992-12-31  |  10.5 KB  |  226 lines  |  [TEXT/R*ch]
  1. RELEASE NOTES FOR SHANE THE PLANE...
  2.  
  3.  
  4. Words to wade through...
  5.  
  6. 1. This software is named for Shane Stanley, de facto product
  7. manager for all of my commercial programs and the quiet voice of
  8. reason behind virtually everything I do. Shane has been unstinting
  9. in the benefits he has conferred upon me, and I can never hope to
  10. repay him. I've already written two pieces of software named after
  11. him, but neither was released - the second because it was trivial
  12. and the first because it was a little too user-friendly... But I
  13. wanted to name something (useful) in his honor, and I've been
  14. waiting for the right thing. It happens that I was talking
  15. Wednesday to my daughter (in a very general way) about this
  16. project, written in junk time over the last few days, and I asked
  17. her what I should call it. "Shane the Plane," she said, that being
  18. her name for all airplanes. Shane's name comes up in conversation a
  19. lot, and she worked out the rhyme on her own. And names for
  20. "things" are a big deal right now; the computer I'm working on is
  21. named "Amber", after Meredith's favorite kind of traffic light.
  22. Working in KidWorks 2, we hacked an icon together, painted brown to
  23. blend into the rugged outback.
  24.  
  25. 2. With some validity, this could be named after Kip Shaw, since it
  26. was he who got me thinking about the problem it solves. We were
  27. whining to each other that File Fanatic isn't quite as smart as we
  28. want it to be. I myself had further need of Shane the Plane's other
  29. features, so I rolled everything into one small utility. Take
  30. heart, Kip: your day will come (grin).
  31.  
  32. 3. What it does: Shane the Plane (optionally) changes the Creator
  33. and Type of files, or the Created and Modified dates, or both. It
  34. works either by Drag & Drop under System 7, or interactively under
  35. either System 6 or System 7. It's 32-bit clean, multi-finder aware,
  36. a real fun date - all the usual stuff. AND: IT'S DAMNED DANGEROUS
  37. FOR NOVICES TO PLAY WITH! If the words "Creator" and "Type" don't
  38. mean anything to you, _don't use this software_. Everything is
  39. safe, nothing is buggy, everything works as it is documented below.
  40. BUT: changing Creator and Type codes is something best left to
  41. people who: A. know what they're doing, B. know why they're doing
  42. it, C. know what objective they hope to achieve by doing it, and D.
  43. know how to _undo_ it. If you don't meet those qualifications, do
  44. yourself (and your "guru") a favor and walk on by...
  45.  
  46. 4. I keep a neat computer. I'm casual to the point of being chaotic
  47. in the real world (e.g., before I married, I had never paid a phone
  48. bill that didn't come in a red-bordered envelope (grin)). But on
  49. the computer, I like things very neat. You probably haven't
  50. noticed, but on every piece of my software the Modified and Created
  51. dates are the same. The big boys have all their files tuned to the
  52. same frequency, but I was happy enough to do a virgin build, to
  53. satisfy my own obsessive tendencies and to demonstrate by a quiet
  54. means that the software wasn't slopped together with baling wire
  55. and tape. Still, I'd always envied the big boys their greater
  56. statement of perfection, so I put the date/time changing business
  57. in Shane the Plane. Now every file you get from me will have the
  58. same one, meaningless, arbitrary date. Strive to contain your
  59. enthusiasm... (grin)
  60.  
  61. 5. This represents a sort of term paper for me. It's almost a year
  62. since I started hacking the Mac, and (IMO) I've come a long way.
  63. Shane the Plane is really a very simple hack, but it deploys some
  64. interesting technology we developed for Mark My Words, and it uses
  65. an on-the-fly text-editing scheme that won't come to full flower
  66. until MyEditor. Moreover, it's deeply and disturbingly dangerous in
  67. places. When I started programming this box, I was doing everything
  68. the safe, stupid way, usually using methods and tools more
  69. appropriate to character-based, command-line-oriented systems. With
  70. each new project, I've stretched a little farther, to the point
  71. that I am now pulling stunts that no sane operating system should
  72. _ever_ permit (grin). I'm a sophomore, now, nothing more. There's
  73. still a _hell_ of a lot more for me to learn. But I'm a sophomore
  74. with a portfolio...
  75.  
  76.  
  77.  
  78. Shane the Plane in operation...
  79.  
  80. Shane the Plane runs out of a single dialog box, plus the menu bar.
  81. About and Quit are familiar to everyone. The Command key
  82. equivalents for Copy, Paste and Cut work. Restore defaults restores
  83. all settings to their "factory" defaults. Restore saved preferences
  84. restores the settings to those most recently saved. And Save
  85. preferences saves the current settings as the future defaults to
  86. use at launch time. In other words, if you have a set of operations
  87. you do endemically, make those your saved preferences. Then, when
  88. you have a job that doesn't fit the mold, make temporary changes,
  89. execute the job, and quit without saving the preferences.
  90.  
  91. In the dialog, the Change Creator/Type check box controls whether
  92. or not the change will be made. If it is unchecked, it won't be.
  93. The two text fields beneath the check box allow you to establish
  94. which Creator and Type codes to use. These default to 'R*ch' and
  95. 'TEXT' because that's what Kip and I wanted and couldn't get File
  96. Fanatic to do.
  97.  
  98. The Change date/time check box controls whether or not the created
  99. and modified dates of the file(s) will be altered. If checked, both
  100. will be changed to the same date and time. The format shown is the
  101. one that must be used; date in the form of MM/DD/YY and time in the
  102. form of HH:MM:SS. Reasonably intelligent error-checking is going on
  103. in these fields when you hit the Start... button.
  104.  
  105. The Default Date/Time pop-up requires a bit of explanation, because
  106. it does two things. First, it establishes the form that the date
  107. and time will take on the next launch (if you Save preferences),
  108. hence "Default". But it _also_ gives you 10 plug-and-play options
  109. to use on the fly. Use preferences uses the strings from the most
  110. recently saved preferences, _not_ the result of the saved state of
  111. the pop-up itself. Likewise for Use defaults. These are provided so
  112. that you can store literal dates and times, as opposed to the
  113. software-generated forms used by the others. Clear as mud? Play
  114. with it in connection with the Preferences menu and you'll see
  115. what's going on.
  116.  
  117. (And: a brief word about date modification: it would be very easy
  118. to use this feature for fraudulent purposes. You could claim to
  119. have started something before you really did, swear up and down
  120. that you didn't make a change that you _did_ make, divert accusing
  121. fingers of blame toward unsuspecting innocents. This is one of the
  122. reasons that Created and Modified are not independently editable: I
  123. can't think of an honorable reason why anyone would need to do
  124. this. But: even so: it's still possible to commit fraud with Shane
  125. the Plane, and all I can say is: I hope you don't. The finite time
  126. of your life is your only asset, and I would hope you wouldn't
  127. choose to squander it with ego-destructive acts...)
  128.  
  129. (And: another brief word about date modification: certain disk
  130. repair utilities (notably The Norton Utilities) don't like files
  131. with odd dates. If you use this time machine to move files to the
  132. distant past, or to any point in the future, prepare to face a
  133. quizzical modal dialog from your disk fixer. No consequences, just
  134. an opportunity to fix or ignore.)
  135.  
  136. Finally: the Start... button sets Shane the Plane in motion. If you
  137. have launched with a Drag & Drop batch, Shane the Plane will
  138. operate on the files one by one, then quit on his own. If not, the
  139. Start... button will bring up a standard Open File dialog, and you
  140. will navigate to your files in the usual way. Shane the Plane
  141. doesn't take full advantage of Apple Events, so you can't Drag &
  142. Drop after a normal double-click launch. Hardly seems an issue,
  143. since this is the very last word in Drag & Drop software...
  144.  
  145. That's it. It's easier than it sounds on paper...
  146.  
  147.  
  148.  
  149. Here's hoping you get what you want for the Holidays!,
  150.  
  151. Greg Swann
  152.  
  153. CIS: 70640,1574
  154. USPS: P.O. Box 1724
  155. Andover, MA 01810
  156.  
  157. 12/23/92
  158.  
  159.  
  160.  
  161. ADDENDUM REGARDING VERSION 1.0.1
  162.  
  163. Hugo Heriz Smith reported that parts of the text in the About box
  164. were getting cut off. I assume that this has to do with different
  165. versions of Geneva (thanks, Apple!), and I assume I've fixed it (I
  166. have no way of checking). In the long run, I think I'm going to
  167. have to go to pictures (as with Snow!), rather than make any
  168. assumptions at all about system resources...
  169.  
  170. And: I've added code to regard '****' as a creator or type wildcard
  171. meaning "stet - leave it the way it already is". I'm not sure this
  172. is entirely useful, but it might be - and I'm a congenital noodler
  173. (grin).
  174.  
  175. 12/26/92
  176.  
  177.  
  178.  
  179. ADDENDUM REGARDING VERSION 1.0.2
  180.  
  181. Kip asked me to find a way to force an immediate Finder update to
  182. reflect changes made by Shane the Plane. After telling him twice
  183. that I couldn't, I found that I could. This version implements that
  184. one change. For Drag & Drop jobs, the changes will become obvious
  185. so near to instantaneously as to make no difference. For
  186. interactive jobs, there will still be some delay, but the changes
  187. will be visible before the wait could possibly make any difference.
  188.  
  189. And: the way I did this amounts to something of an Easter Egg. I
  190. expect that Mike Arst will find it first (he is, after all, Man Of
  191. The Year), but you might want to try to beat him to the punch.
  192.  
  193. (Soft spot: this ends up being the last piece of software that will
  194. carry a 1992 copyright notice. Fitting end to a good year, I
  195. think.)
  196.  
  197. 12/31/92
  198.  
  199.  
  200.  
  201. ADDENDUM REGARDING VERSION 1.0.3
  202.  
  203. This implements another change requested by Kip. If you run by Drag
  204. & Drop, the actual, current Creator and Type will be shown for the
  205. _first_ file in the batch. Nothing has changed for interactive
  206. operation, since we know nothing about the file until microseconds
  207. before it's old news. But, working by D&D, you will know what the
  208. current Creator and Type settings are, which information may induce
  209. you to Quit without making any change. Only the first file in the
  210. batch is shown, so this won't tell you anything about later files
  211. in a mixed batch. And the definition of which is first depends on
  212. the state of the Finder's View menu. In View by Icon and Small
  213. Icon, the first file is the one that is highlighted earliest. In
  214. any of the list views, the first file is the highlighted file that
  215. is topmost in that list.
  216.  
  217. One other change is implemented in this version. I discovered that
  218. I was improperly changing the values of the Saved Preferences in
  219. memory (not on disk) when the Start button was hit. The consequence
  220. was that, interactively, doing Restore Saved Preferences after
  221. having hit Start would show the state of the settings _at the time_
  222. the Start button was hit, rather than their state at the last Save
  223. Preferences. This is fixed.
  224.  
  225. 12/31++/92
  226.